Sets an existing region to be empty.

void SetEmptyRgn (
     rgn
);

Parameter descriptions

rgn

A handle to the region to be made empty.

DISCUSSION

The SetEmptyRgn function destroys the previous structure of the region whose handle you pass in the rgn parameter; it then sets the new structure to the empty region defined by the rectangle (0,0,0,0).

SPECIAL CONSIDERATIONS

The SetEmptyRgn function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)